home *** CD-ROM | disk | FTP | other *** search
/ SuperHack / SuperHack CD.bin / CODING / INTERNET / CBUTTON.ZIP / README.TXT < prev    next >
Encoding:
Text File  |  1996-06-24  |  11.1 KB  |  220 lines
  1. *****************************************************************
  2. *                                                               *
  3. *                           CBUTTON (F1.2)                      *
  4. *                                                               *
  5. *                         Written by Mark Qian                  *
  6. *                                                               *
  7. *                             - Adware -                        *
  8. *****************************************************************
  9.  
  10.    
  11.  
  12.  
  13. CBUTTON, Command Button, is a JAVA applet written 
  14. by Mark Qian. It works as a command button with pictures 
  15. and scrolling and muilt-line caption.  It also provides sound
  16. when mouse over or click.  Its on_click parameter allows you 
  17. open a given URL address when clicking.  In additional, it allows you display a
  18. message in the status bar when mouse cursor move over the applet. Details
  19. about how to install it in your page is available in below.
  20.  
  21. NOTE:      Both Adware (FREE) and shareware (NOT FREE) versions are 
  22.            available. The parameters marked with (share) are only 
  23.            available in shareware version. 
  24.            
  25.            
  26. Good News!!
  27.  
  28.            
  29.            You can now use Adware version of CButton with full-feature during the period other than business hours.
  30.            That is, all the functions in the Adware are available at a period from 7:00PM - 7:00AM.  You can use your own
  31.            parameters during that period.  But during the period 7:00AM - 7:00PM, the caption and URL will be
  32.            replaced by author's infor and URL.  If you like to use it as an Adware with limited parameters
  33.            instead of evaluate it's full-feature, you need to set parameter whatWare = Adware. 
  34.            (The default of whatWare is evaluteShareware). If you like to have all these features available full-time,
  35.            you need to download the shareware version and register it to get the Registration Code to unzip the
  36.            shareware package.
  37.            
  38.   
  39.                         
  40.  
  41.  
  42.   !!!!!!!!!!!!!!!!  Be sure you try it with your own stuff during 7:00AM - 7:00PM   !!!!!!!!!!!!!!!!!!!
  43.                        
  44.  
  45.                     
  46.            
  47. IMPORTANT:
  48. *********  You have to make sure the Adware version (FREE) 
  49.            works fine in your server before you register the 
  50.            shareware version because you are buying a Code.
  51.            That is, after you register the shareware (pay fee)
  52.            only thing you will recieve is a Code which can be
  53.            used to unzip the shareware package.  The Code is
  54.            NOT refundable, NOT returnable, and NOT exchangable.
  55.            Don't register the shareware if you are NOT sure
  56.                - It REALLY WORK in your server
  57.                - You REALLY like to use the shareware.
  58.                
  59.  
  60. Parameters:
  61.           captionMode  - The way caption is displayed: 
  62.                         0 - display a static (still) multi-line caption.  Of course, you
  63.                             can display only a single line caption by provide only one
  64.                             caption text and set parameter, numcaption to 1. 
  65.                             Note: Multi-line is only available in shareware version (share).
  66.                         1 - display a scrolling (moving) single-line caption horizontally.  Caption1, 
  67.                             caption2, ..., captionN will be scrolled in the order of their
  68.                             numbers. (share)      
  69.                         2 - display a scrolling (moving) single-line caption vertically.  Caption1, 
  70.                             caption2, ..., captionN will be scrolled in the order of their
  71.                             numbers. (share)     
  72.                         3 - display Caption1 originally and display caption2 after a click. Switch between
  73.                             Caption1 and Caption2 when clicking.
  74.  
  75.           speed        - The speed of caption motion(1 - 30).  
  76.           soundmode    - The way sound is played.
  77.                         0 - Sound is played when mouse cusor over Animator
  78.                         1 - Sound is played when clicking.
  79.           audiofile    - The audio file that should reside in
  80.                         the directory where the applet resides.
  81.           upImage      - The image displayed when cbutton is not pressed.
  82.           downImage    - The image displayed when cbutton is pressed.
  83.           numCaption   - Number of caption text.   
  84.           
  85.           fixCaption   - Display a static caption at the first row.
  86.           fixCaptionColor - Determinate the color of the static caption.   
  87.           fixCaptionHeight - Height of static caption area.
  88.           fixCaptionBlink - Make the static caption blick.
  89.           
  90.           caption1     - Caption text 1
  91.           caption2     - Caption text 2  (share)
  92.           ...
  93.           captionN     - Caption text N  (share)
  94.        
  95.           borderWidth  - The bevelwidth of left and right edges(in pixel).Set to 0 if you don't
  96.                          like to have a border. 
  97.           borderHeight - The bevelwidth of top and bottom edges(in pixel)
  98.           fontHeight   - The size of caption font(1-100).
  99.           
  100.           fgcolor      - Color of caption. You need to use the same code format like you use
  101.                          in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
  102.                          Value "vary" will give caption a random color periodically.
  103.            
  104.           background   - URL of the Image which is used to paint caption area's background.
  105.                          This URL has to be a local one such as "images/brnpapr.gif".
  106.                          You can not use a URL that point to an address that is not in
  107.                          the server where the applet resides. If parameter background
  108.                          is valid, bgcolor will be ignored.
  109.                                          
  110.           bgcolor      - Color of caption background. This feature can be overrided by 
  111.                          parameter background(That is, if background presents, bgcolor
  112.                          will not effect. You need to use the same code format like you use
  113.                          in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
  114.                          Value "vary" will give caption background a random color each time
  115.                          the applet is called.
  116.                          
  117.           fixCaptionColor  - Color of static caption. You need to use the same code format like you use
  118.                          in HTML script such as #ff00ff.  You can also set fgcolor = "vary".
  119.                          Value "vary" will give static caption a random color periodically.                                        
  120.          
  121.           status_text - status text which will be displayed in the status.
  122.                         Just set it to "" to disable it. (share)
  123.           action      - determinate what to do when click
  124.                         "URL" - open the URL specified by "on_click"
  125.                         "SoundSwitch" - Turn Sound On or Off.(Note: This can only control those
  126.                                         sounds played by Mark's applets.
  127.           on_click    - an URL address whose content will be opened by browser
  128.                         when clicking at the applet.  Just set it to "" to disable it.  
  129.  
  130. INSTALLATION:
  131. ============           
  132.           
  133. If you are a webmaster or experienced person, just follow the brief
  134. instructions below. 
  135.  
  136. IMPORTANT:
  137. =========
  138.    
  139.    *********************************************************************************
  140.    *                                                                               *
  141.    *   If you are NOT familiar with Java applet installation an Unix environment,  *
  142.    *   Please follow the detail instructions in                                    *
  143.    *                                                                               *
  144.    *   http://ourworld.compuserve.com/homepages/mark_qian                          *
  145.    *                                                                               *
  146.    *   to install it.  Don't try it youself.                                       *
  147.    *                                                                               *
  148.    *********************************************************************************
  149.  
  150.  
  151.  
  152. BRIEF INSTRUCTIONS (for experienced people only):
  153. ==================
  154.   
  155.   0). Unzip CBUTTON.ZIP in your local machine (you had done this step).
  156.   
  157.   
  158.   1). Rename class files. Because PKUNZIP will extract the
  159.       class file, cbutton.class, to CBUTTON.CLA,  you have to RENAME 
  160.       the class file to cbutton.class and rename COMMON.CLA to common.class.  
  161.       Note: class names has to be lower case.     
  162.   
  163.   2). Open TEST_CB.HTM with your browser locally. If it works locally,
  164.       go to next step.  Otherwise, go to Mark's home page for detail
  165.       instructions.
  166.       
  167.   3). Try TEST_CB.HTM online(Ignore this step if you think that you 
  168.       REALLY know what to do). 
  169.   
  170.          - place cbutton.class and common.class in the place you want in your server.
  171.            (FTP program may change cbutton.class to talk.cla. Rename class file
  172.             if needed).
  173.          - place TEST_CB.HTM, MAIL_B*.GIF, and LAUGH.AU to the same directory
  174.          - change access attributes of all the files above to readable(744)
  175.          - Browse TEST_CB.HTM from your local machine
  176.          
  177.       If it works, go to next step.  Otherwise Go to Mark's page for instructions.
  178.          
  179.    
  180.    4).Use your own stuff
  181.          
  182.      - add following HTML statements into your HTML's body  
  183.  
  184.      
  185.        <applet code="cbutton.class" width=155 height=85>
  186.        <param name=captionMode value="0">
  187.        <param name=speed value="5">
  188.        <param name=soundmode value="2">
  189.        <param name=audiofile value="WOLF.AU">
  190.        <param name=upImage value="IN_RV_1.GIF">
  191.        <param name=downImage value="IN_RV_2.GIF">
  192.        <param name=borderWidth value="3"> 
  193.        <param name=borderHeight value="3"> 
  194.        <param name=fontHeight value="15"> 
  195.        <param name=numCaption value="1"> 
  196.        <param name=caption1 value="Cool Screen Savers!!"> 
  197.        <param name=caption2 value="Mark Qian's">
  198.        <param name=caption3 value="pageto get">
  199.        <param name=caption4 value="more fun!">
  200.        <param name=textAreaHeight value="20"> 
  201.        <param name=colorR value="255"> 
  202.        <param name=colorG value="0"> 
  203.        <param name=colorB value="0"> 
  204.        <param name=on_click value="http://www.aimnet.com/~markqian/SCREENSA.HTM">     
  205.        <param name=status_text value="My message is here.">     
  206.        </applet>
  207.          
  208.   
  209.       - replace parametes such as "primarysound" and "sndsound" with your stuff.
  210.   
  211.   
  212.   5). If it works, enjoy it!! (If you like to do its hard-working author a favor, Drop him an 
  213.       EMail to let Mark know It runs OK).  Otherwise, go to Mark's page for detail instructions
  214.       of troubleshooting.
  215.  
  216.  
  217.     
  218. Go Mark's Home Page(http://ourworld.compuserve.com/homepages/mark_qian") to see more exciting applets!
  219.  
  220.